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Overview 


The KPod USB device interface use the simple generic HID protocol of communicating 
with a USB host. All command and return data use 8 byte EPO packets. Commands are 
sent to the KPod using an 8 byte command packet, and data is then returned in an 8 
byte report packet. After every command is sent, a USB read must be performed, even 
for commands that return no data. 


USB Device Information (from the device descriptor) 


USB spec: 2.0 
class code: 0x00 
sub class: 0x00 
protocol: 0x00 
EPO pkt size: 0x08 
Vendor ID: 0x04D8 
Product ID: OxF1i2D 


Command Packet (PC > KPod) 
The command packet structure consists of a 1 byte command and 7 bytes of data: 


struct USB_CmdPacket 

{ 
unsigned char cmd; 
unsigned char data[7]; 


i 


cmd holds the command (see command list) 
data holds optional arguments for the command 
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Command List (details shown on next page) 


Get Update 


Get ID 


Get Version 


Force FW load 


Reset 
Configure 


LED/Aux Control 
Beep Control 


Report Packet (KPod > PC) 


struct USB_ReportPkt 


{ 


unsigned char 


inti6_t 


unsigned char controls; 
unsigned char spare[4]; 


y; 


cmd - holds copy of command that requested this report 
ticks - accumulated encoder ticks, positive = CW, negative = CCW 


ticks; 


cmd; 


// command reply 
// encoder tick count, signed 16 bit 
// button, tap/hold and rocker state 
// spares, TBD 


controls: 
bit 7 bit O 

unused Rocker_1 |Rocker_O |Tap/Hold /|Button_3 /Button_2 /Button_1 |Button_0O 
Button: 0x01 = button 1 press 

0x02 = button 2 press 

0x08 = button 8 press 
Tap/Hold: 0 = tap 

1 = hold 

Rocker: 00 = center (VFO B) 
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01 = 
10 = 
11 


right (RIT/XIT) 


left (VFO A) 


error 


Command Reference 


u' get update - Signals the KPod to return an update report. The KPod will set the 
returned packet's cmd to 'u' if there was a new event (encoder, button, or 
rocker), otherwise the cmd will be set to 0. 


"=! get ID - Returns the string “KPOD” in the report packet. The report packet is 
cast as 1 byte command and 7 bytes data: 


struct id_report_packet 
{ 


unsigned char cmd; // will contain ‘=’ 
char id_string[7]; // will contain “KPOD” 


J; 


get version - The version of the KPod application firmware is returned encoded as 
BCD in the report's ‘ticks’ field. (example: 1.08 = 108) 


'b' jump to bootloader - Internal Use Only 
r' reset — forces a hard reset of the KPod. This will reset the USB interface. 
bi Gg Configure - The first byte of the command packet data field holds a bit pattern 


which is used to control various configuration settings. 


b7 b6 b5 b4 b3 b2 bi bO 


- z k = z = SCALE MUTE 


SCALE Writing a 1 at this bit position sets the encoder scale at 100 counts 
per revolution, while writing a O sets the default of 200 counts. 


MUTE Writing a 1 at this bit position enables beeper mute, while writing a 0 
disables mute. 
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'O' LED/Aux control - The first byte of the command packet data field holds a bit 
pattern which is used to turn on/off the LEDs and/or the Aux Outputs. 


b7 b6 b5 b4 b3 b2 b1 bO 
LEDR LED_4 LED_3 LED_2 LED_1 AUX_3 AUX_2 AUX_1 
AUX 1-3 Writing a 1 at this bit position turns the AUX_n output on (grounds 
the pin), while a O will turn it off, opens the connection to ground. 
LED 1-4 Writing a 1 turns the LED on, O turns it off. (see LEDR below) 
LEDR Writing a 1, LEDs will be controlled by the KPod's rocker switch. 


Writing a 0, LEDs will be controlled by LED bit commands. 


Note: LED D4 is always controlled by LED bit commands. 


‘Z. Beep Control - The first 3 bytes of the data portion of the command packet hold 


the parameters: 


(end) 
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data[1] - tone level: 


data[2] - duration: 


data[0] - tone frequency: 


0O = 1000 Hz 

1 = 1500 Hz 

2 = 2000 Hz 
3-255 = 500 Hz 
0 = low 

1 = medium 
2-255 = high 
0-255 * 10 ms 


